home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / elist21.zip / EASYLIST.DOC next >
Text File  |  1991-11-04  |  12KB  |  397 lines
  1.  
  2.  
  3.               -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  4.                               E a s y L i s t
  5.               -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
  6.                                 by Jim Barry
  7.  
  8.          A user list generator for version 2.15+ of Searchlight BBS
  9.                            version 2.1  (11/4/91)
  10.  
  11.  
  12. ::::::::::::::::::
  13. :::  Overview  :::
  14. ::::::::::::::::::
  15.  
  16.     Congratulations!  You have just unzipped, perhaps, the most powerful
  17.     utility program ever written for Searchlight BBS sysops.  EasyList is a
  18.     program that allows you to generate listings of your users based on
  19.     criteria YOU select and output in a format YOU define.
  20.  
  21.     Once you have used the program a few times, you will begin to see the
  22.     endless number of possibilities available to you.  I hope you find this
  23.     program useful, as it cost me a few sleepless nights.
  24.  
  25.  
  26. ::::::::::::::::
  27. ::: Contents :::
  28. ::::::::::::::::
  29.  
  30.     The following files should be contained in this .ZIP:
  31.  
  32.         EASYLIST.DOC  - The file you are now reading
  33.         EASYLIST.EXE  - The actual EasyList program
  34.  
  35.    If any of these files are not contained in the file you unzipped, please
  36.    contact the SYSOP of the BBS from which you obtained it and ask him to
  37.    delete the file.  Thanks!
  38.  
  39.  
  40. ::::::::::::::::::
  41. :::  Features  :::
  42. ::::::::::::::::::
  43.  
  44.     The following is a list of 'features' offered by EasyList:
  45.  
  46.     - Generate lists of your users to the screen, printer, or disk file
  47.  
  48.     - Perform searches on any or all of the following information:
  49.         Name, Location, System Type, Phone, Access Level, File Access
  50.         Level, Time Limit, Times Called, First Call Date, Last Call Date,
  51.         K-Byte Uploaded, K-Byte Downloaded
  52.  
  53.     - Output any or all of the above parameters... in ANY order you choose!
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                  - Page 1 -
  65.  
  66.  
  67.  
  68.  
  69. ::::::::::::::::::::::
  70. :::  Installation  :::
  71. ::::::::::::::::::::::
  72.  
  73.  
  74.     EasyList need not be placed in your .BBS directory, since you can
  75.     specify with the '-p <path>' option the location of you USER.SL2 file.
  76.     Therefore, wherever you choose to keep EASYLIST.EXE is fine.
  77.  
  78.  
  79. :::::::::::::::
  80. :::  Usage  :::
  81. :::::::::::::::
  82.  
  83.  
  84. --- A few words about "RANGE" Specifications ------------------------
  85.  
  86. Throughout the "options" documentation, you will be told about specifying
  87. ranges for access levels, dates, File Transfer amounts.
  88.  
  89. Date Ranges: <date1>,<date2>
  90.  
  91.    8/15/90,10/15/90  (all dates between 2 specified including
  92.                       8-15-90 and 10-15-90)
  93.  
  94.    8/15/90,          (all dates after 8-15-90 including 8-15-90)
  95.  
  96.    ,10/15/90         (all dates before 10-15-90 including 10-15-90)
  97.  
  98. Numeric Ranges: <r1>,<r2>
  99.  
  100.   100,200            (all values between 100 and 200 including
  101.                       100 and 200)
  102.  
  103.   50,                (all values greater than or equal to 50)
  104.  
  105.   ,120               (all values less than or equal to 120)
  106.  
  107.  
  108. Basically, for a range, you have a starting value and ending value.
  109. <start>,<end>.  If either is omitted, it is assumed to have no value.
  110.  
  111. Range Limits:
  112.  
  113. -a, -f, -t      : 0 to 255
  114. -w, -x, -c      : 0 to 65535
  115.  
  116. ---------------------------------------------------------------------
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                  - Page 2 -
  131.  
  132.  
  133.  
  134.  
  135. Format:  EASYLIST [options]
  136.  
  137. Options:
  138.  
  139.  
  140. -a <r1>,<r2>            | searches for users whos access level falls
  141.                           in the range <r1> to <r2>.
  142.  
  143.                           Example:  EASYLIST -a 50,100
  144.                           selects users with access 50-100
  145.  
  146.                           Example:  EASYLIST -a 100,
  147.                           selects users with access at least 100
  148.  
  149. -f <r1>,<r2>            | searches for users whos file access level falls
  150.                           within the range <r1> to <r2>.
  151.  
  152.                           Example:  EASYLIST -f 10,50
  153.                           selects users with file access 10-50
  154.  
  155.                           Example:  EASYLIST -f ,100
  156.                           selects user with file access up to 100
  157.  
  158. -c <r1>,<r2>            | searches users whos total calls falls within
  159.                           range <r1> to <r2>.
  160.  
  161.                           Example:  EASYLIST -c 5,50
  162.                           selects users with total calls between 5 and 50
  163.  
  164.                           Example:  EASYLIST -c 10,
  165.                           selects users with total calls of at least 10
  166.  
  167. -t <r1>,<r2>            | searches for users whos time limit falls
  168.                           in the range <r1> to <r2>.
  169.  
  170.                           Example:  EASYLIST -t 50,100
  171.                           selects users with time limit 50-100
  172.  
  173.                           Example:  EASYLIST -t 100,
  174.                           selects users with a time limit at least 100
  175.  
  176. -w <r1>,<r2>            | searches for users whos total uploaded k-bytes
  177.                           falls in the range <r1> to <r2>.
  178.  
  179.                           Example:  EASYLIST -w 100,1000
  180.                           selects users who have uploaded between 100K
  181.                           and 1 Meg
  182.  
  183.                           Example:  EASYLIST -w 1000,
  184.                           selects users who have uploaded at least 1 Meg
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                  - Page 3 -
  197.  
  198.  
  199.  
  200.  
  201. -x <r1>,<r2>            | searches for users whos total downloaded k-bytes
  202.                           falls in the range <r1> to <r2>.
  203.  
  204.                           Example:  EASYLIST -w 100,1000
  205.                           selects users who have downloaded between 100K
  206.                           and 1 Meg
  207.  
  208.                           Example:  EASYLIST -w 1000,
  209.                           selects users who have downloaded at least 1 Meg
  210.  
  211. -s "<string>"[,N,L,S,P] | searches for <string> in Name, Location, or
  212.                           System Type.  Search is NOT case sensitive.
  213.                           Optional [,N,L,S,P] are for N=name, L=location,
  214.                           S=system type,P=phone.  If no option is given,
  215.                           searches N,L,S.
  216.  
  217.                           Example:  EASYLIST -s "cleveland",L,N
  218.                           displays all users whos Location contains
  219.                           'cleveland'
  220.  
  221.                           Example:  EASYLIST -s "ibm"
  222.                           displays all users whos Name, Location, or System
  223.                           Type contains 'ibm'
  224.  
  225.                           Example:  EASYLIST -s "351-8890",P
  226.                           displays all users whos Phone Number contains
  227.                           '351-8890'
  228.  
  229. -n                      | disables '--more--' prompting
  230.                           Note, it is not necessary to use this prompt when
  231.                           using the "-o" command.
  232.  
  233.                           Example:  EASYLIST -n
  234.  
  235. -b <n1>                 | specifies how many lines to print before skipping
  236.                           a line.  Defaults to 0, which is no
  237.                           blank lines.
  238.  
  239.                           Example:  EASYLIST -b 3
  240.                           prints a blank line after every 3 users are
  241.                           printed
  242.  
  243. -y <date1>,<date2>      | searches for users whos first logon date was
  244.                           between <date1> and <date2>.
  245.                           <date> = MM-DD-YY   ("/" may be used for "-")
  246.  
  247.                           Example:  EASYLIST -y ,5-1-90
  248.                           displays users whos first logon date was BEFORE
  249.                           or equal to 5/1/90
  250.  
  251.                           Example:  EASYLIST -y 6-15-90,8/15/90
  252.                           displays users whos first logon date was between
  253.                           6-15/90 and 8/15/90.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                  - Page 4 -
  263.  
  264.  
  265.  
  266.  
  267. -z <date1>,<date2>      | searches for users whos last logon date was
  268.                           between <date1> and <date2>.
  269.                           <date> = MM-DD-YY   ("/" may be used for "-")
  270.  
  271.                           Example:  EASYLIST -y ,5-1-90
  272.                           displays users whos last logon date was BEFORE or
  273.                           equal to 5/1/90
  274.  
  275.                           Example:  EASYLIST -y 6-15-90,8/15/90
  276.                           displays users whos last logon date was between
  277.                           6-15/90 and 8/15/90.
  278.  
  279. -l [N,L,Y,Z,C,S,        | specifies "layout" of fields for outputting.
  280.     P,A,F,T,W,X]          You may specify any of up to 12 parameters to
  281.                           display and may use them more than once.
  282.                           Valid Fields:
  283.                             N = User Name        P = Phone No
  284.                             L = Location         A = Access Level
  285.                             Y = First Date On    F = File Access Level
  286.                             Z = Last Date On     T = Time Limit
  287.                             C = Total Calls      W = K-byte Uploaded
  288.                             S = System Type      X = K-byte Downloaded
  289.  
  290.                           Example:  EASYLIST -l N,L,P
  291.                           displays Name, Location, & Phone Number
  292.  
  293.                           Example:  EASYLIST -l N,A,N,F
  294.                           displays Name, Access, Name, & File Access
  295.  
  296. -o <filespec>           | sends output to the specified file or device
  297.  
  298.                           Example:  EASYLIST -o C:\BBS\USER.LST
  299.                           writes user list to file named USER.LST in
  300.                           directory C:\BBS
  301.  
  302.                           Example:  EASYLIST -o LPT1
  303.                           writes output to printer connected to LPT1
  304.  
  305. -p <path>               | specifies path to USER.SL2 file
  306.  
  307.                           Example:  EASYLIST -p C:\BBS
  308.                           searches for USER.SL2 in C:\BBS
  309.  
  310. Any of the above commands may be grouped together.
  311.  
  312. Samples:
  313.  
  314.   Sample #1:
  315.  
  316. EASYLIST -a 50,100 -f 50,50 -s "akron",L -b 5 -o TEST.TXT
  317.   outputs to file TEST.TXT all users whos Access Level is 50-100 AND whos
  318.   File Access is 50 AND whos location contains the word 'akron'.  Also
  319.   outputs with a blank line 5 users.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                  - Page 5 -
  329.  
  330.  
  331.  
  332.  
  333.   Sample #2:
  334.  
  335. EASYLIST -a 75, -c 10, -w ,1000 -s "apple",S -l C,Z,N,W,S
  336.   outputs to screen all users whos access level is at least 75 and have
  337.   called at least 10 times and who have uploaded less than 1000K and whos
  338.   System Type contains the word "apple".  Outputs Calls, Last-on, Name, K-
  339.   bytes Uploaded, System Type.
  340.  
  341.  
  342. ::::::::::::::::::::
  343. :::  Disclaimer  :::
  344. ::::::::::::::::::::
  345.  
  346.     I have tested this program to the best of my abilities and believe it
  347.     to be void of any and all bugs.  I attest that when I released this
  348.     program, there were no "undocumented" features herein.  I give no
  349.     warrantees or guarantees as to the correct operation of this software.
  350.     I will not be liable for any incidental or consequential damages as a
  351.     result of the use of this software.
  352.  
  353.     (I hate writing that kinda stuff)
  354.  
  355.  
  356. :::::::::::::::::::::::::
  357. :::  Acknowledgments  :::
  358. :::::::::::::::::::::::::
  359.  
  360.     - Frank LaRosa, for writing a fabulous BBS program, of which without,
  361.       EasyList would have no use.
  362.     - Borland International, for providing the world with Turbo Pascal
  363.       (EasyList is compiled in Turbo Pascal 5.5)
  364.  
  365.  
  366. ::::::::::::::::::
  367. :::  Farewell  :::
  368. ::::::::::::::::::
  369.  
  370.     Comments and Suggestions may be mailed to:
  371.  
  372.                C.C.S. Systems
  373.                PO Box 35487
  374.                Cleveland, OH  44135-0487
  375.  
  376.     And if your really in the mood to get in touch with me, (or at least
  377.     the latest release of EasyList), you can call my BBS:
  378.  
  379.                Time Vault BBS  (pcp: OHCLE) (Starlink: 4222, 10077)
  380.                (216) 951-9150, 8-N-1, 3/12/2400 Baud
  381.  
  382.     And remember:  When a program has no bugs...  It's obsolete!
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                  - Page 6 -
  395.  
  396.  
  397.